home *** CD-ROM | disk | FTP | other *** search
/ Stone Design / Stone Design.iso / Stone_Friends / Wave / WavesWorld / Source / Libraries / tcl7.4b3 / doc / linsert.n < prev    next >
Encoding:
Text File  |  1995-01-30  |  1.1 KB  |  36 lines
  1. '\"
  2. '\" Copyright (c) 1993 The Regents of the University of California.
  3. '\" Copyright (c) 1994-1995 Sun Microsystems, Inc.
  4. '\"
  5. '\" See the file "license.terms" for information on usage and redistribution
  6. '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  7. '\" 
  8. '\" @(#) linsert.n 1.4 95/01/30 10:35:42
  9. '\" 
  10. .so man.macros
  11. .HS linsert tcl 7.4
  12. .BS
  13. '\" Note:  do not modify the .SH NAME line immediately below!
  14. .SH NAME
  15. linsert \- Insert elements into a list
  16. .SH SYNOPSIS
  17. \fBlinsert \fIlist index element \fR?\fIelement element ...\fR?
  18. .BE
  19.  
  20. .SH DESCRIPTION
  21. .PP
  22. This command produces a new list from \fIlist\fR by inserting all
  23. of the \fIelement\fR arguments just before the \fIindex\fRth
  24. element of \fIlist\fR.  Each \fIelement\fR argument will become
  25. a separate element of the new list.  If \fIindex\fR is less than
  26. or equal to zero, then the new elements are inserted at the
  27. beginning of the list.  If \fIindex\fR
  28. .VS
  29. has the value \fBend\fR,
  30. .VE
  31. or if it is greater than or equal to the number of elements in the list,
  32. then the new elements are appended to the list.
  33.  
  34. .SH KEYWORDS
  35. element, insert, list
  36.